home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat5 / libirixpmda.z / libirixpmda
Encoding:
Text File  |  2002-10-03  |  11.5 KB  |  265 lines
  1.  
  2.  
  3.  
  4. LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))                                                  LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa - performance metrics domain agent for IRIX
  10.  
  11. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  12.      lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa is a Performance Metrics Domain Agent (PMDA) for the
  13.      Performance Co-Pilot (see PPPPCCCCPPPPIIIInnnnttttrrrroooo(1)) which uses system calls to obtain
  14.      performance metrics from the IRIX kernel.  lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa is loaded by
  15.      ppppmmmmccccdddd(1) as a Dynamically Shared Object (DSO) when ppppmmmmccccdddd(1) is started.
  16.  
  17.      lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa exports metrics from many kernel subsystems, including:
  18.  
  19.      ddddiiiisssskkkk          Disks and disk controllers
  20.  
  21.      ffffiiiilllleeeessssyyyyssss       Filesystem usage
  22.  
  23.      hhhhiiiinnnnvvvv          System configuration
  24.  
  25.      hhhhuuuubbbb           Origin hub error counts
  26.  
  27.      hhhhwwww            R10K and Origin router hardware counters
  28.  
  29.      iiiippppcccc           Inter-process communication protocols
  30.  
  31.      kkkkaaaaiiiioooo          Kernel asynchronous I/O
  32.  
  33.      kkkkeeeerrrrnnnneeeellll        CPU and system call activity
  34.  
  35.      mmmmeeeemmmm           Physical and virtual memory usage
  36.  
  37.      nnnneeeettttwwwwoooorrrrkkkk       Network interface utilization
  38.  
  39.      nnnnffffssss           NFS utilization
  40.  
  41.      nnnnooooddddeeee          Origin node memory usage
  42.  
  43.      nnnnuuuummmmaaaa          Origin page migration activity
  44.  
  45.      rrrreeeessssoooouuuurrrrcccceeee      Kernel resources
  46.  
  47.      rrrrppppcccc           RPC client/server activity
  48.  
  49.      sssswwwwaaaapppp          Memory swap activity
  50.  
  51.      xxxxbbbboooowwww          Origin xbow I/O throughput
  52.  
  53.      xxxxffffssss           XFS file system activity
  54.  
  55.      xxxxllllvvvv           XLV volume activity
  56.  
  57.      uuuuddddffff           UDF file system activity
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))                                                  LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))
  71.  
  72.  
  73.  
  74.      The entire list of metrics exported by lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa can be obtained with
  75.      the ppppmmmmiiiinnnnffffoooo(1) command:
  76.  
  77.                > pminfo irix hinv hw
  78.  
  79.      All metrics collected by lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa have a help text entry that can be
  80.      displayed with:
  81.  
  82.                > pminfo -T irix.kernel.all.cpu.user
  83.  
  84.      The set of metrics that are available will vary between each IRIX release
  85.      and hardware platform.
  86.  
  87. EEEENNNNAAAABBBBLLLLIIIINNNNGGGG OOOOFFFF SSSSTTTTAAAATTTTIIIISSSSTTTTIIIICCCCSSSS CCCCOOOOLLLLLLLLEEEECCCCTTTTIIIIOOOONNNN
  88.      Several kernel subsystems (or clusters of metrics) must have their
  89.      statistics gathering explicitly enabled. In the cases where the
  90.      collection process is expensive, we require that the user manually enable
  91.      the collection process, in other cases lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa will automatically
  92.      enable it.
  93.  
  94.      Manually enabled metrics include the R10k event counters (hw.r10kevctr)
  95.      and the Crossbow metrics (irix.xbow).  The automatically enabled metrics
  96.      include the xlv metrics (irix.xlv).  To activate the system-level
  97.      processor event counters (hw.r10kevctr) you must run eeeeccccaaaaddddmmmmiiiinnnn(1) as root,
  98.      e.g.
  99.  
  100.           _eeee_cccc_aaaa_dddd_mmmm_iiii_nnnn _----_aaaa
  101.  
  102.      would enable all of the processor event counters.  To activate the
  103.      Crossbow metrics (irix.xbow) see the section below on storing to
  104.      irix.xbow.switch.
  105.  
  106.      The xlv metrics are enabled at startup if the xlv statistics gathering is
  107.      found to have been turned off. The xlv statistics can be manually turned
  108.      off via
  109.  
  110.           _xxxx_llll_vvvv______mmmm_gggg_rrrr _----_RRRR_xxxx_cccc _""""_cccc_hhhh_aaaa_nnnn_gggg_eeee _ssss_tttt_aaaa_tttt _oooo_ffff_ffff_""""
  111.  
  112.      and manually turned on via
  113.  
  114.           _xxxx_llll_vvvv______mmmm_gggg_rrrr _----_RRRR_xxxx_cccc _""""_cccc_hhhh_aaaa_nnnn_gggg_eeee _ssss_tttt_aaaa_tttt _oooo_nnnn_""""
  115.  
  116.      If the statistics are manually turned off then when libirixpmda next
  117.      detects this, it will write out a warning message to the log,
  118.      ////vvvvaaaarrrr////aaaaddddmmmm////ppppccccpppplllloooogggg////ppppmmmmccccdddd....lllloooogggg.  If the statistics are subsequently turned back
  119.      on, then this fact will also be logged when libirixpmda next detects it.
  120.      Note, however, libirixpmda will only ever turn on the xlv statistics at
  121.      startup or whenever libirixpmda is reset.
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))                                                  LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))
  137.  
  138.  
  139.  
  140. STORABLE METRICS
  141.      Several metrics may be altered using the ppppmmmmssssttttoooorrrreeee(1) command to change the
  142.      behavior of lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa.  These metrics are:
  143.  
  144.      _i_r_i_x._p_m_d_a._r_e_s_e_t
  145.          Reset the entire lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa causing every cluster to reinitialize
  146.          and probe the system configuration from scratch.  If the system
  147.          configuration has changed in a way that lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa cannot easily
  148.          detect and/or handle, such as adding or removing disks with ssssccccssssiiiihhhhaaaa(1)
  149.          or ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp(1), a value should be stored into this metric:
  150.  
  151.                > pmstore irix.pmda.reset 1
  152.  
  153.      _i_r_i_x._p_m_d_a._d_e_b_u_g
  154.          By default, only error messages are dumped by lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa to the
  155.          ppppmmmmccccdddd(1) log file.  Additional output can be generated by storing any
  156.          combination of these flags into _i_r_i_x._p_m_d_a._d_e_b_u_g:
  157.  
  158.          1111      General
  159.  
  160.          2222      Instance domains
  161.  
  162.          4444      CPU metrics
  163.  
  164.          8888      Disk metrics
  165.  
  166.          11116666     Node metrics
  167.  
  168.          33332222     Fetch from ppppmmmmccccdddd(1)
  169.  
  170.          66664444     High precision counters
  171.  
  172.          111122228888    Xbow metrics
  173.  
  174.          222255556666    XLV volumes
  175.  
  176.          555511112222    Mounted EFS, XFS and UDF file systems
  177.  
  178.          1111000022224444   Network interfaces
  179.  
  180.          2222000044448888   Memory Audit
  181.  
  182.      _i_r_i_x._x_b_o_w._s_w_i_t_c_h
  183.          By default, the _i_r_i_x._x_b_o_w metrics are turned off as they can affect
  184.          the performance of the XBow hardware on Origin systems.  To turn all
  185.          XBow metrics on, run the command:
  186.  
  187.                > pmstore irix.xbow.switch 1
  188.  
  189.          while storing 0 will turn all Xbow monitoring off.  Individual XBows
  190.          can turned on and off by specifying the XBow instances.  For example,
  191.          to monitor only the first two XBows on an Origin system, you may do
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))                                                  LLLLIIIIBBBBIIIIRRRRIIIIXXXXPPPPMMMMDDDDAAAA((((5555))))
  203.  
  204.  
  205.  
  206.          these commands:
  207.  
  208.                > pmstore irix.xbow.switch 0
  209.                > pmstore -i"xbow0,xbow1" irix.xbow.switch 1
  210.  
  211.          Every time a Xbow is stopped or started, the _i_r_i_x._x_b_o_w._g_e_n generation
  212.          number will increment.  This can be used by specialized clients
  213.          receiving these metrics to detect the re-initialization of the XBow
  214.          counters so that bogus values are not used.
  215.  
  216.          XBows may also be monitored by xxxxbbbbssssttttaaaatttt(1).  Only one of xxxxbbbbssssttttaaaatttt(1) and
  217.          lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa may monitor the same XBow at the same time.
  218.  
  219. FFFFIIIILLLLEEEESSSS
  220.      /_u_s_r/_p_c_p/_l_i_b/_m_i_p_s_AAAABBBBIIII._l_i_b_i_r_i_x_p_m_d_a._s_o
  221.           The location of lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa where AAAABBBBIIII may be either o32, n32 or 64
  222.           depending on the running kernel.
  223.  
  224.      /_v_a_r/_p_c_p/_p_m_d_a_s/_i_r_i_x
  225.           The location of the lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa help text.
  226.  
  227.      /_v_a_r/_p_c_p/_p_m_n_s/_r_o_o_t__i_r_i_x
  228.           the Performance Metrics Namespace (PMNS) for lllliiiibbbbiiiirrrriiiixxxxppppmmmmddddaaaa.
  229.  
  230.      /_v_a_r/_a_d_m/_p_c_p_l_o_g/_p_m_c_d._l_o_g
  231.           The default location of the ppppmmmmccccdddd(1) log file.
  232.  
  233. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  234.      PPPPCCCCPPPPIIIInnnnttttrrrroooo(1), ppppmmmmccccdddd(1), ppppmmmmiiiinnnnffffoooo(1), ppppmmmmssssttttoooorrrreeee(1), ssssccccssssiiiiaaaaddddmmmmiiiinnnnsssswwwwaaaapppp(1), ssssccccssssiiiihhhhaaaa(1)
  235.      and xxxxbbbbssssttttaaaatttt(1).
  236.  
  237. DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  238.      All diagnostics are reported in the ppppmmmmccccdddd(1) log file,
  239.      /_v_a_r/_a_d_m/_p_c_p_l_o_g/_p_m_c_d._l_o_g.  The verbosity of output may be controlled by
  240.      storing appropriate flags into _i_r_i_x._p_m_d_a._d_e_b_u_g.
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                                                         PPPPaaaaggggeeee 4444
  262.  
  263.  
  264.  
  265.